home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_amanda.idb / usr / freeware / doc / amanda / SYSTEM.NOTES.z / SYSTEM.NOTES
Encoding:
Text File  |  1999-07-16  |  9.3 KB  |  239 lines
  1. Amanda 2.4 - System-Specific Installation Notes
  2.  
  3. Please read the notes that correspond to the architectures you are
  4. installing for.  If you find additional gotchas, or anything incorrect
  5. in these notes, please send your updates to amanda-hackers@cs.umd.edu,
  6. after checking that they are not known/fixed problems in the amanda
  7. patches page: http://www.amanda.org/patches.html
  8.  
  9. ---------------------------------------------------------------------------
  10. Solaris 2.6
  11. -----------
  12.  
  13. You may have compilation errors on statfs.c if you're running, on a
  14. Solaris 2.6 host, a gcc that was not build on a Solaris 2.6 host.
  15. This happens because gcc stores fixed copies of some Solaris header
  16. files on an internal directory.  You must rebuild gcc if you get this
  17. kind of trouble.  Note, however, that gcc 2.7.2.3 does not support
  18. Solaris 2.6, you should upgrade to 2.8.0 or higher, or egcs.
  19.  
  20. ---------------------------------------------------------------------------
  21. SunOS 4.x
  22. ---------
  23.  
  24. A bug in GNU tar 1.12 causes it to miscalculate (in fact, to
  25. misreport) the size of filesystems.  A patch for GNU tar is available
  26. in the patches directory.
  27.  
  28. ---------------------------------------------------------------------------
  29. Ultrix
  30. ------
  31.  
  32. The Ultrix dump program contains an explicit check that it is being
  33. run by root.  This defeats the usual practice of a non-root "operator"
  34. userid for dumps.  For this reason, the rundump program (a setuid-root
  35. wrapper for dump) is enabled by default.  If you find rundump is not
  36. necessary for you, just configure --without-rundump.
  37.  
  38.  
  39. The Ultrix restore program will fail if it is not connected to a tty.
  40. Since the restore program is invoked in the clients in order to create
  41. index files, and it the client is not connected to a tty, index
  42. creation will fail.  Using GNUTAR instead of DUMP is an option.
  43. Thanks to Edwin Wiles <ewiles@mclean.sterling.com> for the
  44. investigation.  Another alternative proposed by Martyn Johnson
  45. <Martyn.Johnson@cl.cam.ac.uk> is to use a modified restore program:
  46. use a binary program editor and replace `/dev/tty' with `/dev/nul',
  47. for instance, and link /dev/nul to /dev/null.  Note that the chosen
  48. file name must be exactly 8 bytes long, otherwise you'll break the
  49. restore program.  A nice one-liner perl script by Martyn Johnson will
  50. do the trick (make sure you preserve a copy of the original restore
  51. program, it will be rewritten by running this script!):
  52.  
  53. perl -pi -e 'BEGIN { $/ = "/dev/tty" } s-$/-/dev/nul-' restore
  54.  
  55. ---------------------------------------------------------------------------
  56. HP/UX
  57. -----
  58.  
  59. You may run into an internal /bin/sh limit when running the configure
  60. script.  The error message is:
  61.  
  62.     ./configure: sh internal 2K buffer overflow
  63.  
  64. Using /bin/posix/sh usually works around the problem.  Another
  65. solution is to install GNU bash and use it instead of /bin/sh.
  66.  
  67.  
  68. If `configure' complains about not finding `lex', you'll have to get
  69. `flex' installed.  Look for its URL in docs/INSTALL.
  70.  
  71.  
  72. If you use logical volumes, you may refer to mountpoints or full
  73. device pathnames instead of device names in the disk list file.
  74.  
  75.  
  76. According to Stan Brown <stanb@awod.com>, amverify won't work with
  77. HP/UX's stock `mt'.  The work-around is to install GNU cpio, that
  78. contains an implementation of `mt', and edit amverify so that MT
  79. points to GNU mt and MTOPT is `-f', or reconfigure and rebuild amanda
  80. from scratch, making sure it finds GNU mt before the stock mt in the
  81. PATH.
  82.  
  83.  
  84. If you have vxfs filesystems to back up, amanda will pick vxdump
  85. automatically.
  86.  
  87.  
  88. GNU tar 1.12 will incorrectly report the size of backups.  There's a
  89. patch in the patches directory that fixes this problem.
  90.  
  91.  
  92. The use of `amhpfixdevs' is deprecated, since you can list
  93. mount-points or full device names in the disklist.  The script may be
  94. removed in future releases of Amanda.
  95.  
  96. ---------------------------------------------------------------------------
  97. Linux
  98. -----
  99.  
  100. Linux hosts intended to back up efs partitions with dump should
  101. install the dump package, as it is not installed by default on most
  102. Linux distributions.  It is possible to find compiled versions of dump
  103. on most Linux sites and CD-ROMs.
  104.  
  105.  
  106. Make sure the user that runs configure has permission to run the dump
  107. program, otherwise configure may misdetect an ability of dump to
  108. accept a -E (for estimates) switch.
  109.  
  110.  
  111. GNUtar 1.11.8, distributed with some Linux versions, will cause index
  112. failures (Index returned -1).  Upgrading to GNUtar 1.12 fixes this
  113. problem.  This is not a Linux-specific problem, but it is quite common
  114. in this platform.
  115.  
  116.  
  117. Amanda now supports the ftape driver version 3.04d.  It adjusts the
  118. blocksize automatically to 32k and supports QIC volume tables.  More
  119. details con be found in the file ZFTAPE in this directory.
  120.  
  121.  
  122. Some releases of dump for Linux, such as the one distributed with
  123. Debian 2.0, have modified dump so that it stores dumpdates in
  124. /var/lib.  If this is your case, you should create a link to it in
  125. /etc.  Suggested by David Wolfskill <dhw@whistle.com>
  126.  
  127. ---------------------------------------------------------------------------
  128. Digital Unix 4
  129. --------------
  130.  
  131. According to Michael Galloway <mgx@spruce.lsd.ornl.gov>, the stock
  132. DUX4 dump is broken.  There is a patch available at
  133. ftp://ftp.service.digital.com/public/dunix/v4.0b/duv40bas00005-19970926.README
  134.  
  135.  
  136. When both dump and vdump are available, amanda will use vdump for
  137. backing up advfs filesystems only, and dump will be used for the rest.
  138. If you'd rather back up all filesystems with vdump, #undef DUMP in
  139. config/config.h after running configure.
  140.  
  141.  
  142. Unfortunately, the output of `dump -E' incorrectly matches a line of
  143. output from SAMBA, which gets Amanda's estimate process confused.
  144. client-src/sendsize.c will refuse to compile if both
  145. HAVE_DUMP_ESTIMATE and SAMBA_CLIENT are defined in config/config.h.
  146. Amanda will work correctly if you undefine HAVE_DUMP_ESTIMATE in
  147. config/config.h; if you prefer to have incorrect estimates for SAMBA
  148. backups, follow the instructions in sendsize.c on removing the
  149. compile-time error.
  150.  
  151.  
  152. According to Oren Laadan <orenl@cs.huji.ac.il>, DEC compiler version
  153. "DEC C V5.2-033 on Digital UNIX V4.0 (Rev. 564)" (obtained with "cc -V")
  154. does not build Amanda properly, in particular, taper.c.  Using gcc is OK.
  155.  
  156. ---------------------------------------------------------------------------
  157. Sinix 5.43 (Reliant Unix)
  158. -------------------------
  159.  
  160. The use of `amsinixfixdevs' is deprecated, since you can list
  161. mount-points or full device names in the disklist.  The script may be
  162. removed in future releases of Amanda.
  163.  
  164. Sinix port originally by Michael Schmitz <mschmitz@iname.com>.
  165.  
  166. ---------------------------------------------------------------------------
  167. IRIX (all)
  168. ----------
  169.  
  170. When setting the tape device name in either amanda.conf or one of the
  171. changer configuration files, make sure you specify the "variable" device
  172. name, which has a 'v' on the end.  If not, IRIX will write 4KByte blocks
  173. instead of the 32KByte blocks Amanda tells it to.  This apparantly works
  174. OK unless you take the tape to a non-IRIX system, where amrestore will
  175. complain about a short (4096) read.
  176.  
  177. If you do end up in this situation, the dd command to use to pipe into
  178. your system restore program is:
  179.  
  180.     dd if=/dev/whatever bs=4k skip=8 | ...
  181.  
  182.  
  183. Jean-Francois Malouin <Jean-Francois.Malouin@bic.mni.mcgill.ca>
  184. reports that, if you are going to use an IRIX host as the tape server,
  185. you *must* patch your system with *all* kernel and scsi rollup
  186. patches, otherwise you may end up with useless tapes, due to tape
  187. rewinding after short periods of inactivity.  See
  188. http://www-viz.tamu.edu/~sgi-faq/ for more details.
  189.  
  190. ---------------------------------------------------------------------------
  191. IRIX 6
  192. ------
  193.  
  194. Seems like SGI `make' program is a bit broken, in a way that causes it
  195. to rebuild some files if doesn't have to if you happen to run `make'
  196. again.  Using GNU make fixes this problem.
  197.  
  198.  
  199. If you have xfs filesystems to back up, amanda will pick xfsdump
  200. automatically.
  201.  
  202.  
  203. ---------------------------------------------------------------------------
  204. SCO
  205. ---
  206.  
  207. Jens Krause <jens@transcom.de> has reported some problems with GNU tar
  208. 1.12 on SCO Release 5.  Although the `sparse' files patch was applied,
  209. GNU tar would consistently crash.  GNU tar had to be built linked with
  210. malloc-libraries, and the `--sparse' switches had to be removed from
  211. client-src/sendbackup-gnutar.c and client-src/sendsize.c.
  212.  
  213.  
  214. ---------------------------------------------------------------------------
  215. FreeBSD 3.0
  216. -----------
  217.  
  218. chg-scsi was not updated to support the new camlib.h-dependent chio.h,
  219. so chg-scsi will be automatically disabled if camlib.h is found.  You
  220. may use chg-chio instead.
  221.  
  222.  
  223. ---------------------------------------------------------------------------
  224. Microsoft Windows
  225. -----------------
  226.  
  227. Although amanda won't run standalone on MS-Windows hosts, it is
  228. possible to use it to back up their disks, by using SAMBA.  Please
  229. read docs/SAMBA for more information.
  230.  
  231. SAMBA may be unable to back up some files due to file locking
  232. restrictions.  Particularly, paging and registry files usually present
  233. problems.  Backing up page files is pointless, but registry files are
  234. quite important to back up.  It is possible to create regular files
  235. that contain registry information by using the Regback utility, from
  236. the Windows NT Resource Kit.  Unfortunately, is not part of the
  237. Windows NT standard distribution, you have to parchase it separately.
  238. Thanks to Ernie Oporto <ernie_oporto@mentorg.com> for the tip.
  239.